home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_a / htcust.doc < prev    next >
Text File  |  1995-04-22  |  9KB  |  177 lines
  1. Documentation for "The HomeTerm Customizer" 
  2. ------------------------------------------ 
  3.  
  4. Program written by Russ Wetmore for Star Systems Software, Inc. 
  5. Copyright (c) 1984 by Star Systems Software, Inc. 
  6. All rights reserved. 
  7. HomeTerm and HomePak are trademarks of Batteries Included. 
  8.  
  9. Portions of this program were written using Action! and the Action Runtime 
  10. Package. 
  11. Action! is a trademark of Action Computer Services. 
  12. Portions of this program are Copyright (c) 1983, 1984 by Action Computer 
  13. Services. 
  14.  
  15. Permission is granted for non-commercial usage only.  This program may be copied 
  16. and distributed freely, provided that you do not attempt to sell it, use it as 
  17. the basis for a commercial program, or otherwise obtain or attempt to obtain any 
  18. financial gain from it.  You may modify it in any way that you feel appropriate 
  19. within these limits. 
  20.  
  21. With all the formalities out of the way..... 
  22.  
  23.  
  24. RUNNING THE PROGRAM 
  25. ------------------- 
  26. (All instructions regarding DOS commands assume usage of DOS 2.0S, or its 
  27. equivalent.) 
  28.  
  29. Before you begin, you must make a backup copy of your original HomePak master 
  30. disk.  The manner in which you copy it is crucial - you must make your copy from 
  31. DUP.SYS by using the "J" command.  You cannot simply copy files from the HomePak 
  32. master disk.  The Customizer assumes absolute positioning of the files on the 
  33. disk, and a "J" copy is the only way you can be assured of this. 
  34.  
  35. Load the Customizer from the DUP.SYS menu, using the "L" command.  (The 
  36. Customizer was written in Action!, but you don't need the Action! cartridge to 
  37. run it.)  You will first be presented with a prompt to insert your backup copy 
  38. of the HomePak master in disk drive 1.  Insert the disk and press [RETURN]. 
  39.  
  40.  
  41. THE MAIN MENU 
  42. ------------- 
  43. The main menu has 8 selections.  To make a change to a particular option, or to 
  44. load one of the other two menus, press the number key in the left column.  (i.e. 
  45. To change option 2, press the [2] key.) 
  46.  
  47. Item 1 (Other R: handlers (ATR)) is primarily for ATR-8000 users running the 
  48. RS-232 version of MYDOS.  You can toggle between the "DEFAULT" setting (use 
  49. HomePak's built in handler) and the "other.." setting (use a non-standard R: 
  50. handler.)  ATR-8000 users should choose "other..". 
  51.  
  52. Item 2 (Key repeat rate) is for those users who have special hardware or special 
  53. versions of Atari's O/S with a built in fast key repeat rate.  The default 
  54. setting is "FAST".  Those with such special hardware, or who wish a slower 
  55. cursor speed should choose "NORMAL". 
  56.  
  57. Item 3 (Automatic Line Feed) allows you to set whether or not a Line Feed 
  58. character (ASCII 10) is sent automatically after a Carriage Return (ASCII 13).  
  59. Some modems (notably Rixon) and some services such as many RCP/M BBS's and 
  60. Delphi, require that a line feed NOT be sent after a carriage return.  If you 
  61. are having difficulty with a BBS accepting your input after you press return, 
  62. you should try to change this to "OFF".  ("ON" is the default setting.)  Turning 
  63. this option to "OFF" won't affect most services, but some require it, so only 
  64. change it if you are having problems with this. 
  65.  
  66. Item 4 ('Stop' code (XOFF)) and item 5 ('Start' code (XON)) are for those people 
  67. who use systems that don't use the usually standard XON/XOFF control codes.  It 
  68. is rare anymore to find a system that doesn't.  It is probably a good idea not 
  69. to change this unless you know exactly what is going on.  In these items, and in 
  70. the joystick keys menu, control characters are shown as their letter equivalent 
  71. preceded with a "^" character.  SHIFT-CTRL-keys are shown as "SHIFT^" except for 
  72. SHIFT-CTRL-0 to -9 which are Macro keys in HomeTerm. 
  73.  
  74. Item 6 (Character set menu) and item 7 (Joystick key menu) take you into the 
  75. other two menus in the Customizer.  They will be discussed later. 
  76.  
  77. Item 8 (Bell on prompt) affects the "* Press any key *" prompt that frequently 
  78. occurs in HomeTerm.  You can turn the bell "ON" or "OFF".  ("ON" is the default 
  79. setting.) 
  80.  
  81. From the main menu, once you have finished making alterations to the various 
  82. defaults, you can write your changes out to your backup of the HomePak master 
  83. disk by pressing the [START] button.  Or, you can exit the program without 
  84. making any changes at all by pressing the [X] key.  You will be prompted to 
  85. insert your backup disk in disk drive 1 (if it isn't there already) and given 
  86. one last chance to change your mind.  In either case, press the [Y] key if you 
  87. want to write/exit and any other key to abort. 
  88.  
  89.  
  90. CHARACTER SET MENU 
  91. ------------------ 
  92. HomeTerm uses two character sets, one being the master HomePak set and other 
  93. being the standard Atari set.  There are several public domain and commercial 
  94. character set editors that allow you to create your own character sets, which 
  95. you might want to substitute for the HomePak set. 
  96.  
  97. Item 1 (Load new character set from disk) allows you load your own character set 
  98. and make it the HomePak "master" set.  (Note that this change (and items 2 and 
  99. 3) affect ALL 3 PROGRAMS.)  When asked, supply the disk filename of your 
  100. character set and press [RETURN].  Because telecommunications requires a full 
  101. ASCII set, the Customizer automatically alters ASCII 96 and ASCII 123 to 127 to 
  102. their proper ASCII equivalents.  (The copyright symbol at ASCII 16 is also kept, 
  103. partly for esthetic and partly for legal reasons.) 
  104.  
  105. Item 2 (Use default HomePak set) changes the character set back to the original 
  106. set, and item 3 (Use standard ATARI set) changes it to the standard ATARI set.  
  107. Your currently selected set is always shown in the menu, and is the one that 
  108. will be written as the master set. 
  109.  
  110. Items 4, 5, and 6 affect the behavior of character set changes when switching 
  111. translation modes.  Normally, the default is for the master character set to be 
  112. used whenever in VIDTEX or ASCII mode, and the standard ATARI set when in ATARI 
  113. mode.  Item 4 changes HomeTerm to use the master set in all modes; select item 5 
  114. to use the standard ATARI set in all modes and item 6 to go back to the normal 
  115. default. 
  116.  
  117. Note that several ATARI set graphics characters are used in menus and prompts, 
  118. and your display may look "funny" if your set doesn't contain them.  It doesn't 
  119. affect the program's operation in any way, but for cosmetic reasons you will 
  120. probably want to retain the normal graphics set in your custom set if you want 
  121. to use one, and only change numbers, letters, and punctuation. 
  122.  
  123.  
  124. JOYSTICK KEYS MENU 
  125. ------------------ 
  126. One feature that was not disclosed in the manual is the ability to use a 
  127. joystick (plugged into port 1) to send keystrokes.  Each direction on the 
  128. joystick (forward, back, right and left) correspond to a keystroke, and the 
  129. joystick button sends a fifth.  Since HomeTerm Macros are sent via a single 
  130. keystroke - you guessed it - you can send whole strings of commands using one 
  131. joystick movement.  The default settings are RETURN (button), CTRL-Q (forward), 
  132. CTRL-S (back), Macro 5 (left) and CTRL-P (right).  I use this configuration 
  133. myself, with Macro 5 being set to: 
  134.     ^P^W:SK 
  135. where ^P and ^W stand for CTRL-P and CTRL-W respectively.  This macro halts the 
  136. current message being displayed, waits for a ':' (in the (UA RE D): prompt) and 
  137. then sends SK[RETURN] which skips over all replies to the message - handy for 
  138. skipping over messages you have no interest in.  Using this default 
  139. configuration, you can scan the entire message base without ever having to touch 
  140. the keyboard (excepts perhaps to answer a message.) 
  141.  
  142. Items 1 through 5 allow you to change the key associated with a particular 
  143. direction or the button, and item 6 resets all stick keys to their HomeTerm 
  144. defaults.  When asked to press a key that corresponds to a particular item, 
  145. press the combination of keys that you'd normally type in its place - hold own 
  146. CTRL and press a key for a control character and SHIFT-CTRL-0 to -9 for macros, 
  147. as examples.  See the 'Start' and 'Stop' codes item in the main menu docs above 
  148. for an explanation of how the characters are displayed on the screen. 
  149.  
  150.  
  151. CREATING A STANDALONE HOMETERM DISK 
  152. ----------------------------------- 
  153. In order to crea